package com.retail.user.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.retail.user.dto.UserCreateDTO;
import com.retail.user.dto.UserQueryDTO;
import com.retail.user.dto.UserUpdateDTO;
import com.retail.user.dto.UserVO;
import com.retail.user.entity.User;

import java.util.List;

/**
 * 用户服务接口
 * 
 * @author retail-platform
 * @since 2024-09-25
 */
public interface UserService {

    /**
     * 分页查询用户列表
     * 
     * @param queryDTO 查询条件
     * @return 用户列表
     */
    IPage<UserVO> getUserPage(UserQueryDTO queryDTO);

    /**
     * 根据用户ID查询用户详情
     * 
     * @param userId 用户ID
     * @return 用户详情
     */
    UserVO getUserById(Long userId);

    /**
     * 创建用户
     * 
     * @param createDTO 用户创建信息
     * @return 用户ID
     */
    Long createUser(UserCreateDTO createDTO);

    /**
     * 更新用户
     * 
     * @param updateDTO 用户更新信息
     * @return 是否成功
     */
    boolean updateUser(UserUpdateDTO updateDTO);

    /**
     * 删除用户
     * 
     * @param userId 用户ID
     * @return 是否成功
     */
    boolean deleteUser(Long userId);

    /**
     * 重置用户密码
     * 
     * @param userId 用户ID
     * @param newPassword 新密码
     * @return 是否成功
     */
    boolean resetPassword(Long userId, String newPassword);

    /**
     * 根据用户名查询用户
     * 
     * @param username 用户名
     * @return 用户信息
     */
    User getUserByUsername(String username);

    /**
     * 根据邮箱查询用户
     * 
     * @param email 邮箱
     * @return 用户信息
     */
    User getUserByEmail(String email);

    /**
     * 根据手机号查询用户
     * 
     * @param phone 手机号
     * @return 用户信息
     */
    User getUserByPhone(String phone);

    /**
     * 检查用户名是否存在
     * 
     * @param username 用户名
     * @param excludeUserId 排除的用户ID（用于更新时检查）
     * @return 是否存在
     */
    boolean isUsernameExists(String username, Long excludeUserId);

    /**
     * 检查邮箱是否存在
     * 
     * @param email 邮箱
     * @param excludeUserId 排除的用户ID（用于更新时检查）
     * @return 是否存在
     */
    boolean isEmailExists(String email, Long excludeUserId);

    /**
     * 检查手机号是否存在
     * 
     * @param phone 手机号
     * @param excludeUserId 排除的用户ID（用于更新时检查）
     * @return 是否存在
     */
    boolean isPhoneExists(String phone, Long excludeUserId);

    /**
     * 更新用户最后登录信息
     * 
     * @param userId 用户ID
     * @param loginIp 登录IP
     * @return 是否成功
     */
    boolean updateLastLoginInfo(Long userId, String loginIp);
}

